home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_3 / issue04 / info / extras / dir next >
Encoding:
Text File  |  1990-01-11  |  5.2 KB  |  126 lines
  1.  
  2. > ADFS:$.!Dir.Readme - Documentation for DIR SELECT 1.01 10 December 1989
  3.   ------------------   --------------------------------------------------
  4.  
  5.   DIR SELECT is a small multitasking application designed to run under the
  6.   Archimedes RISC-OS Desktop. It provides a convenient way of setting the
  7.   current directory in the Desktop environment. Applications that are
  8.   really compatible with RISC-OS and the Desktop environment are completely
  9.   independent of whatever directory is set as the current directory, but
  10.   there are many other applications and occasions when it is important to
  11.   have the correct directory selected. It is these situations where DIR
  12.   SELECT can be very useful.
  13.  
  14.   DIR SELECT Version 1.00 was dated 12 August 1989. Version 1.01 contains
  15.   some minor updates (see later).
  16.  
  17.   DIR SELECT supports both the ADFS and RamFS, but not NetFS.
  18.  
  19.   DIR SELECT can be installed on the icon bar by double clicking on the
  20.   !Dir directory icon in a directory viewer. Once installed, it can be used
  21.   as follows:
  22.  
  23.   (a) If a directory icon is dragged from a directory viewer to the !Dir
  24.       icon on the icon bar, then that directory will be made the current
  25.       directory
  26.  
  27.   (b) If the !Dir icon is dragged from the icon bar to a directory viewer,
  28.       the the directory represented by that viewer is made the current
  29.       directory
  30.  
  31.   (c) If the menu button is clicked over the !Dir icon on the icon bar
  32.       a three choice menu appears. The selections are "Info", "Root" and
  33.       "Quit".
  34.  
  35.       The simplest choice is "Quit" which causes !Dir to terminate. Its
  36.       icon disappears from the icon bar.
  37.  
  38.       Both "Info" and "Root" have arrows indicating sub-menus.
  39.  
  40.       Moving the pointer onto the arrow against "Info" will just display 
  41.       basic information about the program, such as the version number.
  42.  
  43.       Moving the pointer onto the arrow against "Root" will display a
  44.       sub-menu with one choice for each configured drive, and for the
  45.       RAM disk if it is configured. Selecting one of these, sets the
  46.       root directory on that drive as the current directory. Selecting
  47.       "Root" on the parent menu sets the root directory of the current
  48.       drive as the current directory.
  49.  
  50.   The directory !Dir contains two different versions of DIR SELECT,
  51.   although these are functionally equivalent:
  52.  
  53.   (1)  Dir Select BASIC version which was the first to be written and was
  54.        written in BASIC. It includes a debugging facility which was used
  55.        to investigate the various responses from Wimp_Poll. Full
  56.        documentation is included in REMs within the program, which is
  57.        called "!RunBasic".
  58.  
  59.   (2)  Dir Select machine code version which was written to produce a
  60.        current directory select application which would occuppy the 
  61.        minimum amount of memory. Again, full documentation is included
  62.        in the source program, which is called "DirSlctSrc". The actual
  63.        executable program is called "!RunImage".
  64.  
  65.   The !Run file in the !Dir application directory is set up to run the
  66.   machine code version. To use the BASIC version instead:
  67.  
  68.        Rename the "!Run" file to "!RunMC"
  69.        Rename the "!RunBas" file to "!Run"
  70.  
  71.   The files in the !Dir directory are as follows:
  72.  
  73.        !Run        -   !Run file for the machine code version
  74.  
  75.        !RunBas     -   !Run file for the BASIC version
  76.  
  77.        !RunBasic   -   Executable BASIC version
  78.  
  79.        !RunImage   -   Executable machine code version
  80.  
  81.        !sprites    -   Sprites file
  82.  
  83.        ReadMe      -   This file
  84.    
  85.   Every effort has been made to try to ensure that this program is error
  86.   free and behaves as expected. Please report any errors found to ARCHIVE.
  87.  
  88.   Permission is granted by the author to make additional copies, or 
  89.   modify the program in any way seen fit with the proviso that such
  90.   modified versions are clearly labelled so as to avoid confusion with
  91.   the original version in the case of reporting errors etc.
  92.  
  93.   Differences between Version 1.00 and Version 1.01
  94.   -------------------------------------------------
  95.  
  96.   Version 1.01 has been updated with the benefit of information from
  97.   the new RISC-OS Programmer's Reference Manuals. In general, comments
  98.   have been improved to show the actual use made of the RISC-OS Data
  99.   Transfer Protocol. Overall integrity has also been improved by
  100.   including a test to verify that the application with which DIR SELECT
  101.   is communicating via the Data Transfer Protocol is the Filer task
  102.   (i.e. icon drags occur between our icon and a directory viewer and
  103.   not a window or icon belonging to another application). The
  104.   specific changes made are as follows:
  105.  
  106.     -  optional icon positioning at left/right of icon bar via 
  107.        "iconposition" parametric variable
  108.  
  109.     -  parent box bounds for icon dragging corrected to work in all
  110.        screen modes (e.g. did not work in mode 16)
  111.  
  112.     -  menu positioning brought into line with Acorn suggested values
  113.        from RISC-OS PRM
  114.  
  115.     -  validation that window, from which directory icon is dragged
  116.        to the !Dir icon on the icon bar, really is a directory viewer
  117.        belonging to the "Filer" task
  118.  
  119.     -  validation that window, to which the !Dir icon is dragged from
  120.        the icon bar, really is a directory viewer
  121.  
  122.     -  use Wimp_SetColour instead of GCOL
  123.  
  124.     -  information window flags changed to new style.
  125.  
  126.